home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / nt / vmail104.zip / VMAIL.TXT < prev    next >
Text File  |  1993-09-28  |  11KB  |  232 lines
  1. VanceMail! For Windows 32 
  2. Version 1.04
  3.  
  4. What Is VanceMail! for Windows 32?
  5.  
  6. VanceMail! is a shareware program that will allow you to send
  7. (but not receive) mail if you have a Unix- or mainframe-based
  8. mail system instead of a PC-based mail system like Microsoft
  9. Mail.  It will run on Windows NT machines that use Intel CPUs
  10. and Windows 3.1 and Windows for Workgroups machines which have
  11. Win32s and WinSock installed on them.  Machines must have a
  12. network interface card that allows access to the mail server.
  13. This version of VanceMail! is compiled using the commercial
  14. release of Windows NT.  According to Microsoft programs compiled
  15. with the March beta should have been compatible with the
  16. commercial release, but this was not true of VanceMail! so the
  17. previous version (1.03) will not run on the commercial release
  18. of Windows NT.
  19.  
  20. Technical Details
  21.  
  22. Most Unix- and mainframe-based mail systems use a protocol
  23. called SMTP (Simple Mail Transfer Protocol) to transfer mail
  24. between machines.  The SMTP protocol uses a network
  25. communication mechanism called sockets.  Microsoft recently
  26. added sockets to Windows, and in Windows NT they include
  27. everything that is needed as part of the operating system.
  28. Sockets are implemented using the TCP/IP protocol.  VanceMail!
  29. uses Windows sockets to connect to the SMTP service on your mail
  30. server.
  31.  
  32. Installing VanceMail! on Windows NT machines
  33.  
  34. In order to use VanceMail! you must have the TCP/IP
  35. communications software installed.  Windows NT does not install
  36. the TCP/IP software by default.  Bring up the Network dialog box
  37. from the Control Panel.  If the "Installed Software" listbox
  38. does not include a "TCP/IP Protocol" entry, press the "Add
  39. Software..." button, and install the TCP/IP software.  If you
  40. need to install the TCP/IP software, you will need to restart
  41. your machine before it will be available for VanceMail! to use.
  42.  
  43. Once the TCP/IP software is installed, you will need to edit the
  44. HOSTS file.  This file contains the IP addresses of machines
  45. that you will talk to using the TCP/IP software.  The file is
  46. normally found in the C:\WINNT\SYSTEM32\DRIVERS\ETC directory,
  47. though if you have installed Windows NT on a different drive or
  48. in a different directory the path may be slightly different.
  49. The default HOSTS file looks like this:
  50.  
  51. # Copyright (c) 1992 Microsoft Corp.
  52. #
  53. # This is a sample HOSTS file used by the Microsoft TCP/IP utilities.
  54. #
  55. # This file contains the mappings of IP addresses to host names. Each
  56. # entry should be kept on an individual line. The IP address should
  57. # be placed in the first column followed by the corresponding host name.
  58. # The IP address and the host name should be separated by at least one
  59. # space. Additional aliases or short names for the host may be placed
  60. # on the same line, separated by at least one space, following the
  61. # primary host name.
  62. #
  63. # Additionally, comments (such as these) may be inserted on individual
  64. # lines or following the machine name denoted by a '#' symbol.
  65. #
  66. # For example:
  67. #
  68. #      149.124.10.4     remote.host.com                  # remote MIS host
  69. #      182.102.93.122   patches.server.com    patches    # ACME patch server
  70. #
  71.  
  72. 127.0.0.1       localhost      loopback
  73.  
  74. You will need to add at least two entries.  One entry will be
  75. the IP address of the Windows NT machine itself and the other is
  76. the IP address of the mail server you want to communicate with.
  77.  
  78. Once the TCP/IP software is installed and the HOSTS file is set
  79. up, just copy the file VMAIL.EXE to your hard disk.  You can
  80. create an icon for VanceMail! by dragging the executable file
  81. from the File Manager and dropping it on a group in the Program
  82. Manager.  Double clicking on this icon will start VanceMail!.
  83.  
  84. Installing VanceMail! on Windows 3.1 and Windows for Workgroups
  85. machines
  86.  
  87. In order for VanceMail! to work on a Windows 3.1 or Windows for
  88. Workgroups machine you must also install Win32s version 1.1 or
  89. later (which allows some Win32 programs to run under 16-bit
  90. Windows).  I had originally intended to include it in this
  91. distribution, but every site at which I was intending to put it
  92. already had Win32s available.  You will also need WinSock.
  93. WinSock is a standard way for programs to talk to a TCP/IP
  94. network.  WinSock implementations are available from a variety
  95. of commercial companies (FTP Software and NetManage to name a
  96. couple), and as shareware.  This release of VanceMail! has not
  97. had much testing on the various WinSock implementations, so you
  98. may experience some problems.  Please report them to me and I
  99. will try to get them fixed for the next version.
  100.  
  101. Setting Up VanceMail!
  102.  
  103. The first time you start VanceMail! a dialog box will appear
  104. that you must fill in for VanceMail! to work correctly.  The
  105. first item in the listbox is labeled "SMTP Host:".  In this
  106. field you should enter the name of the mail server machine just
  107. as you entered it in the HOSTS file.
  108.  
  109. The next field is labeled "User:".  You should enter your mail
  110. ID in this field.  It is usually the same as your login ID on
  111. the mail server.
  112.  
  113. The next field, labeled "Reply To:", does not strictly need to
  114. be filled in, but you will probably want to.  When someone
  115. replies to one of your mail messages by default it will go to
  116. "user@Windows-machine" where "user" is the contents of the
  117. previous field and "Windows-machine" is the name of your Windows
  118. machine.  Since most Windows machines will not have an SMTP
  119. service on them that will allow them to receive mail, the reply
  120. will not be able to be delivered.  The "Reply To:" field allows
  121. you to specify a different email address which replies will be
  122. routed to (usually your mail address on the mail server
  123. machine).
  124.  
  125. The final field, labeled "Signature File:" should contain a
  126. complete path and filename of a text file.  A button on the main
  127. window will allow you to append this file to the end of your
  128. mail message.
  129.  
  130. The Save button on the dialog box will allow you to save the
  131. settings to a .INI file (or under Windows NT, Windows NT's
  132. equivalent of the WIN.INI file).  The Use button will allow you
  133. to use the changed values this session, but the next time
  134. VanceMail! is started it will revert to the previously saved
  135. values.
  136.  
  137. Using VanceMail!
  138.  
  139. Now that all the setup is done, I think you will find VanceMail!
  140. very easy to use.  There is a To: field, a Cc: field, a Subject:
  141. field, and a large edit field for the body of your message.  All
  142. of these work like the similar fields in other mail programs.
  143. You enter mail addresses in the To: and Cc: fields separated by
  144. spaces or commas and spaces.
  145.  
  146. The buttons on the toolbar are as follows.  The Send button
  147. sends the mail message.  A message box will appear telling you
  148. whether the message was sent successfully.  An additional
  149. message box will appear if the mail server indicates that any of
  150. the mail addresses are invalid.  Often the mail server will not
  151. indicate any address is invalid when the message is sent, and if
  152. this is the case this message box will not appear.  In this case
  153. the mail server will usually reply to you with a message
  154. indicating that the addressee is unfound.  The File button
  155. allows the user to select a text file, and the file is then
  156. inserted at the last position of the cursor in the message body.
  157. The Signature button appends the signature file to the end of
  158. the body of the message.  The Clear button erases all fields.
  159. The Justify button reformats the paragraph that the cursor is
  160. currently in to have lines no longer than 65 characters.  Blank
  161. lines separate paragraphs.
  162.  
  163. The Properties... menu item in the Options menu will bring up
  164. the setup dialog box at any time.  The Help menu allows you to
  165. bring up help or an about box.  There are also menu items that
  166. let you choose the font for the message area in the Options
  167. menu.
  168.  
  169. Known Bugs
  170.  
  171. The accelerator keys do not work yet.  Tabbing between fields
  172. does not work yet either.  If you have only one line in the
  173. message field the signature file is inserted before it rather
  174. than after it.
  175.  
  176. Bugs Fixed From Version 1.0 to 1.01
  177.  
  178. Some SMTP mail systems require a HELO message at the beginning
  179. of the exchange, and this has been added.  Version 1.0 used the
  180. LAN Manager name of the machine rather than the TCP/IP name of
  181. the machine, and this has been corrected.  The To:, Cc:, and
  182. Subject: fields in version 1.0 would only allow you to enter as
  183. much text as could fit in the visible region.  The fields now
  184. scroll allowing more text.
  185.  
  186. Bugs Fixed From Version 1.01 to 1.03
  187.  
  188. The HELO message now correctly sends the machine name.  The
  189. program now correctly deals with the fact that sometimes sockets
  190. break up a line of text into two or more messages.
  191.  
  192. Changes From Version 1.03 to 1.04
  193.  
  194. The ability to change the font that the message appears in has
  195. been added.  A button to reformat a paragraph has been added.
  196. Help has been added.  This version runs under the commercial
  197. release of Windows NT (the previous version only ran under the
  198. March Beta).  It also allows batch file operation under Windows
  199. NT.  You can invoke it from the command line with a switch and a
  200. file name and it will send a mail message constructed from the
  201. file automatically.
  202.  
  203. Sales Pitch
  204.  
  205. VanceMail! is shareware.  I sincerely hope you find it very
  206. useful.  I am asking that if you do, please send me $25 or more
  207. or less (depending on your opinion of the program) or unused
  208. computer equipment or musical instruments or audio CDs or
  209. CD-ROMs or anything else that you feel is appropriate along with
  210. your name, address, and email address.  I will not sell or give
  211. this information out.  At $25 per registered copy Bill Gates
  212. should not feel threatened by my potential of getting rich.  It
  213. is just a way for you to encourage me to improve the program and
  214. write other related software.  I am providing a companion
  215. program that will allow you to receive SMTP mail at your Windows
  216. machine to those who register.  I hope in the future to create
  217. an SMTP to Microsoft Mail gateway service that runs under
  218. Windows NT, and possibly a similar service that will not require
  219. Windows for Workgroups clients to upgrade to Microsoft Mail 3.0.
  220. If no one registers I may lose interest.  Please send non-lethal
  221. contributions to:
  222.  
  223. Vance Gloster
  224. 180 W. Duarte Rd.
  225. Arcadia, CA 91007
  226.  
  227. I am quite willing to provide site licenses and even source
  228. code.  Please email me with details of your situation for
  229. information.  I can be reached via email at Vance@inference.com.
  230. I have a reasonably demanding job, so please be as brief as
  231. possible.
  232.